home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 476-500 / disk_484 / bootpic / bootpic_anleitung < prev    next >
Text File  |  1992-05-06  |  11KB  |  249 lines
  1. *******************************************************************************
  2. *                                                                             *
  3. *                                 BootPicV1.0                                 *
  4. *                                                                             *
  5. *                         © 1991 by Andreas Ackermann                         *
  6. *                                                                             *
  7. *******************************************************************************
  8.  
  9. ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­
  10. SHAREWARE-BEDINGUNGEN:
  11.  
  12.     BootPic ist SHAREWARE. BootPic darf nur unter folgenden Bedingungen weiter-
  13.     gegeben werden:
  14.  
  15.     o  BootPic darf nicht verändert sein
  16.     o  Dieses DOC-File muß mitkopiert werden
  17.     o  Es darf keine Gebühr erhoben werden (außer Aufwandsentschädigung fürs
  18.        kopieren, Disketten, etc.)
  19.  
  20.     Wenn Ihnen BootPic gefällt und Sie es öfters benutzen oder wenn Sie Teile
  21.     des Source-Codes in eigenen Programmen verwenden (z.B. die Fading-Routinen)
  22.     dann bitte ich um eine kleine Unterstützung in Höhe von ca. 5$ oder 5DM.
  23.  
  24.     Wollen Sie BootPic als Teil eines kommerziellen Programms verwenden,ist mei-
  25.     ne schriftliche Einwilligung erforderlich.
  26.  
  27.     Meine Adresse:         Andreas Ackermann
  28.                            Lorenz-Summa-Str.10
  29.                            W-8679 Oberkotzau
  30.                            Deutschland
  31.                            Tel.:09286/6399
  32.  
  33. ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­
  34. Bitte beachten Sie:
  35. Ich schrieb dieses Programm anstatt einen Ferienjob anzunehmen. Wenn ich auf
  36. diese Weise ein wenig Geld verdienen kann, werden weitere Programme und Updates
  37. folgen (z.B. Colorcycling, Intuition-Benutzeroberfläche, oder wie wär's mit ei-
  38. nem Programm, das ein Library resetfest installiert [wäre hilfreich bei der ARP-
  39. Library] oder einem Generator für Videonachspanne [vertikales Scrolling], der
  40. bis zu 10 Fonts gleichzeitig darstellen kann und obendrein auch noch Teile eines
  41. Bildes scrollt ? )
  42.  
  43.  
  44. INHALT:_________________________________________________________________________
  45.  
  46.  
  47.        1. Einleitung
  48.        2. Aufruf
  49.        3. Zum Parser
  50.        4. Kompatibilität
  51.        5. Was passiert nach einem Reset ?
  52.        6. Mögliche Fehlerquellen
  53.        7. Programmierung
  54.  
  55. ________________________________________________________________________________
  56.  
  57.  
  58.                               EINLEITUNG
  59.  
  60. Gehören Sie auch zu denjenigen Leuten, die die Workbenchhand, die nach jedem
  61. Reset erscheint, langweilig und einfallslos finden ?
  62. Dann ist dieses Programm genau das Richtige für sie. Mit BootPic können sie
  63. (fast) jedes IFF-ILBM-Bild anstelle der «Hand» laden. (Overscan,HAM,HalfBright,
  64. etc.) Es muß lediglich in komprimierter Form vorliegen, ansonsten wäre die Sache
  65. eine reine Speicherverschwendung. (Außer CraphiCraft speichern meines Wissens
  66. alle bekannten Programme ihre Bilder komprimiert,z.B. DPaint I,II,II)
  67. Das installierte Programm verbraucht ca. 1K mehr Speicher, als das IFF-File lang
  68. ist, wobei, falls vorhanden, Fast-Memory verwendet wird.
  69.  
  70.                                  AUFRUF
  71.  
  72. BootPic kann sowohl über die Workbench, als auch via CLI gestartet werden.
  73. Die Steuerung erfolgt jeweils über CommandLine-Parameter.
  74. Bei Start von der Workbench müssen diese in das sich öffnende Fenster eingegeben
  75. werden.
  76. Besonderheiten beim Workbenchstart:
  77.  
  78.  - Vor den Parametern darf NICHT BootPic geschrieben werden, auch wenn
  79.    «Usage:...» dies bei Fehleingaben behauptet.
  80.  - BootPic wird beendet, sobald man ein beliebiges Zeichen eingibt und an-
  81.    schließend RETURN betätigt. Wollen Sie nochmals die Parameter angeben, z.B.
  82.    weil Sie sich verschrieben haben oder Ihre Meinung geändert haben, drücken
  83.    Sie bitte nur RETURN.
  84.  
  85. Es gilt folgender Syntax:
  86.  
  87.                 BootPic -e | -l{IFF-File} [-s][-r][-c rgb]
  88.  
  89. -l{IFF-File}  Löscht, falls vorhanden, ein bereits installiertes Bild und ver-
  90.               sucht dann an dessen Stelle ein neues zu laden.
  91.  
  92.               Erfolgsmeldung:
  93.               «Picture successfully installed. Have Fun !»
  94.  
  95.               Mögliche Fehler:
  96.               «Couldn't open Picture-File»
  97.               BootPic konnte den angegebenen File nicht öffen (z.B. weil er
  98.               nicht vorhanden war)
  99.               «This is not an ILBM-Picturefile»
  100.               Der angegebene File war kein IFF-Bild.
  101.               «Picture is not compressed»
  102.               Das Bild war nicht komprimiert.[Es gibt Tools die unkomprimierte
  103.               Bilder konvertieren.]
  104.               «Warning:Couldn't find CAMG-Chunk»
  105.               CAMG-Chunk nicht gefunden: Hier ist der Viewmodus festgehalten
  106.               [z.B. Hires oder Interlace etc.]. Bis Kickstart V1.3 einschließ-
  107.               lich wird das Bild aber trotzdem korrekt dargestellt.
  108.               [AUSNAHME: statt des Halfbright-Modus wird der HAM-Modus einge-
  109.               schaltet]
  110.               «BODY-Chunk not found»
  111.               Das ILBM-File enthielt keine Bilddaten (sollte niemals vorkommen)
  112.               «Memlist corrupt. Something went totally wrong»
  113.               Bedeutung siehe bei -e
  114.               «Not enough Memory»
  115.               Der Speicher hat nicht ausgereicht.
  116.  
  117. -e            löscht, falls vorhanden, ein bereits installiertes Bild und gibt
  118.               den belegten Speicher frei.
  119.  
  120.               Erfolgsmeldung:
  121.               «Removed BootPic from List»
  122.  
  123.               Mögliche Fehler:
  124.               «BootPic not installed. Couldn't remove it»
  125.               Es war kein Bild geladen und somit konnte auch nichts gelöscht
  126.               werden.
  127.               «Memlist corrupt. Something went totally wrong»
  128.               BootPic hat zwar seinen Speicherbereich entdeckt, konnte aber sei-
  129.               nen Eintrag in der Resident-Tabelle nicht entdecken. (Sollte nie
  130.               passieren.) Falls diese Meldung erscheint, funktioniert entweder
  131.               BootPic fehlerhaft, oder ein anderes Programm, z.B. ein Virus, hat
  132.               sich an den Einsprungaddressen zu schaffen gemacht.
  133.  
  134.               Die folgenden Parameter funktionieren nur zusammen mit der -l
  135.               Option:
  136.  
  137. -s            lädt das unter -l angegebene Bild nur, falls noch kein Bild
  138.               installiert wurde. So ist es möglich, BootPic in der Startup-
  139.               -Sequence zu installieren.
  140.  
  141.               War bereits ein Bild installiert meldet sich BootPic so:
  142.               «BootPic already installed. Changed nothing.»
  143.  
  144. -r            BootPic führt nach dem Laden des Bildes ein Reset aus (nicht
  145.               notwendig)
  146.  
  147. -c            hier können Sie die Farbe angegeben, die nach dem Anzeigen des
  148.               Bildes eingeblendet werden soll. Normalerweise ist dies die Hin-
  149.               tergrundfarbe Ihres Workbench-Screens. Die Werte von r,g und
  150.               b müssen hexadezimal angegeben werden, also sind Werte von 0-9 und
  151.               A-F erlaubt, wobei 0 bedeutet, daß diese Komponente gar nicht und
  152.               F, daß sie mit maximaler Intensität vorhanden ist.
  153.               (z.B. -c000 für schwarz,-ce50 für orange). Andere Werte werden
  154.               zwar auch akzeptiert, aber dann ist das Resultat sicher nicht so
  155.               wie erwartet.
  156.               Voreingestellt ist 05a [Amiga-Blau].
  157.  
  158.  
  159.  
  160. BEISPIEL:
  161. ­­­­­­­­   Um das auf dieser Diskette mitgelieferte Demo-Bild zu installieren,
  162.            gehen Sie bitte folgendermaßen vor:
  163.            Legen Sie diese Diskette in df0: , laden Sie BootPic über die Work-
  164.            bench und geben Sie folgendes ein:
  165.            -l df0:bootpic/demo.pic
  166.            Nachdem das Bild erfolgreich geladen wurde, können Sie es sich nach
  167.            einem Reset betrachten.
  168.  
  169.                                 ZUM PARSER
  170.  
  171.  Alle Parameter können sowohl in Klein- als auch in Großschreibung angegeben
  172.  werden. Jeder Parameter MUSS mit einem «-» beginnen, die Reihenfolge der Pa-
  173.  rameter ist beliebig. Zwischen den einzelnen Parametern können beliebig viele
  174.  Leerzeichen stehen. Logischerweise müssen die Farbwerte nach -c stehen und
  175.  der Filename hinter -l.
  176.  Gültige Aufrufe wären z.B.:
  177.  
  178.   bootpic  -l  df0:meinbild -R   -c  7aB
  179.  
  180.   bootpic -E
  181.  
  182.   bootpic -cAE3  -S -ldf0:meinbild
  183.  
  184.  Wird -e oder -l nicht angegeben, oder stimmt sonst etwas nicht, gibt BootPic
  185.  den Syntax aus.
  186.  Werden -l und -e zusammen angegeben verhält sich BootPic so, als hätte man nur
  187.  -e angegeben.
  188.  
  189.                               KOMPATIBILITÄT
  190.  
  191.  BootPic installiert sich «schonend», d.h. möglicherweise schon vorher vorhande-
  192.  ne resetfeste Programme werden auch weiterhin ausgeführt, z.B. Guardian, CARD:,
  193.  aber auch Viren und sonstige Scherze.
  194.  Genau so sauber entfernt es sich auch wieder (sollte es zumindest).
  195.  
  196.                        WAS PASSIERT NACH EINEM RESET ?
  197.  
  198.  Haben sie BootPic erfolgreich installiert, wird, wannimmer sich nach dem Reset
  199.  keine bootfähige Diskette in DF0: befindet, die geladene Grafik weich einge-
  200.  blendet. Sobald sie eine bootfähige Diskette einlegen, gehen die Farben weich
  201.  in die unter -c angegebene Farbe über und Ihr System fährt wie gewohnt hoch.
  202.  [Das Ein-und Ausblenden von HAM-Bildern sieht ein wenig merkwürdig aus; hier-
  203.  zu wäre eine eigene Routine notwendig, wofür sich aber der Programmieraufwand
  204.  nicht lohnt.]
  205.  Wenn Sie während das Bild am Bildschirm ist die linke Maustaste drücken, er-
  206.  scheint die gewohnte Workbench-Hand. [z.B. hilfreich um zu überprüfen, ob
  207.  Guardian noch installiert ist.]
  208.  
  209.                            MÖGLICHE FEHLERQUELLEN
  210.  
  211.  Normalerweise bleibt ein einmal geladenes Bild solange im Speicher, bis Sie es
  212.  mit -e entfernen oder den Amiga ausschalten.
  213.  Allerdings gibt es einige Ausnahmen:
  214.  
  215.   a.)  Wenn Sie ein Programm benutzen, das meint der gesammte Speicher gehöre
  216.        ihm alleine (viele Spiele tun dies), kann es passieren, daß der von
  217.        BootPic reservierte Speicher überschrieben wird, und das Bild nicht mehr
  218.        erscheint.
  219.   b.)  Viele Viren überschreiben einfach die Resetvektoren. Dann bekommen Sie
  220.        Ihr Bild ebenfalls nicht mehr zu Gesicht.
  221.   c.)  Manche Viruskiller (z.B. ATool) sind der Meinung, alle Programme die re-
  222.        setfest sind, seien Viren (da macht BootPic keine Ausnahme).
  223.  
  224.  Sollte einer dieser drei Fälle eintreten, KANN es vorkommen, daß nach dem
  225.  Reset eine GURU-Meditation erscheint, die sich auch durch Drücken der linken
  226.  Maustaste nicht beseitigen läßt. In solchen Fällen hilft nur Ausschalten.
  227.  
  228.                                PROGRAMMIERUNG
  229.  
  230.  BootPic wurde zu 100% in Assembler verfaßt [Devpac2.14D] , daraus resultiert
  231.  auch die geringe Programmgröße von weniger als 4K. [Nicht einmal halb so lang
  232.  wie diese Anleitung (!).]
  233.  [Für nähere Informationen hierzu siehe den mäßig dokumentierten Quellcode.]
  234.  Vielen Dank auch an JM Forgeas für den einmaligen Editor AZ V1.50.
  235.  
  236.  BootPic läuft sowohl unter Kickstart Version 1.2 als auch 1.3. Leider war es
  237.  mir nicht möglich es unter Kickstart 2.0 zu testen.
  238.  Für Kritik, Lob, Anregungen und vorallem BUG-Reports bin ich sehr dankbar.
  239.  Falls Sie mir schreiben und Antwort erwarten, WÄRE es NETT, wenn Sie gleich ei-
  240.  nen AUSREICHEND FRANKIERTEN und an sich selbst addressierten Briefumschlag mit-
  241.  schicken würden.
  242.  
  243.                          Viel Spaß wünscht Ihnen
  244.  
  245.   Oberkotzau, den 29.3.1991                      Andreas Ackermann [*10.07.1974]
  246.  
  247.  
  248.  
  249.